EmbeddedFrameSpec

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODPart

EmbeddedFrameSpec
The EmbeddedFrameSpec method should create an object specifier for the specified embedded frame in this part.
void EmbeddedFrameSpec (in ODFrame embeddedFrame, 
                        in ODObjectSpec spec);
embeddedFrame
A reference to an embedded frame of this part.
spec
The object specifier for the frame.

DISCUSSION
An object specifier is a designation of a content object within a part. An object specifier is used to determine the target of a semantic event (a message sent to a part or one of its content elements). Object specifiers can be names ("blue rectangle") or logical designations ("word 1 of line 2 of embedded frame 3"). OpenDoc or parts can call this method to create an object specifier for an embedded frame to distinguish it from other frames.
If your part is an embedded part, this method should first obtain the specifier for your part's display frame by calling the EmbeddedFrameSpec method of your part's containing part and then concatenate that returned specifier with the object specifier for the specified embedded frame.

OVERRIDING
When you subclass ODPart, you can override this method. Your override method must not call its inherited method; that is, your override method must implement this method's functionality completely. This method needs to be implemented only by container parts that support scripting.

EXCEPTIONS

kODErrCannotEmbed
This part does not support embedding.
kODErrInvalidFrame
The specified frame is not an embedded frame of this part.

SEE ALSO
Table 2-1 on page 89 in OpenDoc Programmer's Guide.
"Using EmbeddedFrameSpec" on page 437 in OpenDoc Programmer's Guide.